home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / progming / dmake100 / demomake.doc next >
Text File  |  1993-04-09  |  19KB  |  376 lines
  1.  
  2.  
  3.  
  4.  
  5.                           ╒═════════════════╕
  6.                           │ DemoMaker v1.00 │
  7.                           ╘═════════════════╛
  8.                                     Copyright (C)1993 R.Janorkar
  9.                                     Release date 04/09/93
  10.  
  11.         Introduction
  12.         ~~~~~~~~~~~~
  13.         DemoMaker is a software tool that creates presentation demos of
  14.         any DOS based (text mode) software. It allows software authors
  15.         to create live color demonstrations of their products that show
  16.         all the capabilities of their programs, in the form of compact
  17.         self executing presentations. BBS Sysops can use DemoMaker to
  18.         create slide shows of their systems to graphically demonstrate
  19.         all the features their BBS has to offer. The DemoMaker is a
  20.         powerful and easy to use tool!
  21.  
  22.  
  23.         Disclaimer
  24.         ~~~~~~~~~~
  25.         DemoMaker is provided with NO warrantees, expressed or implied.
  26.         Use it at your own risk. The author of DemoMaker will NOT be
  27.         liable for any damages, direct or indirect, arising from the
  28.         ability or disability to use DemoMaker. The use of DemoMaker on
  29.         your computer system indicates your acceptance of these
  30.         disclaimers.
  31.  
  32.  
  33.         Registration
  34.         ~~~~~~~~~~~~
  35.         DemoMaker has been released as fully functional shareware. All
  36.         features are available in the unregistered program to allow you
  37.         to evaluate the program completely. The presentations created
  38.         will, however, display an unregistered message; and a reminder
  39.         screen will appear when DemoMaker is started.
  40.  
  41.         To register this software, mail the enclosed ORDER.FRM to the
  42.         author along with a registration fee of US $20.00 as a check or
  43.         money order (payable in US dollars) to:
  44.  
  45.         R.Janorkar
  46.         651 Richmond Road,
  47.         Staten Island, NY 10304-2409
  48.  
  49.         You will receive a registration number that will eliminate the
  50.         reminder screen, and remove the unregistered message from the
  51.         presentation programs created with DemoMaker. The registration
  52.         number for DemoMaker will be valid for all future releases!
  53.  
  54.  
  55.         Concepts
  56.         ~~~~~~~~
  57.         DemoMaker swaps out of active memory to allow you to execute the
  58.         program that you wish to make a demonstration of. Even though
  59.         DemoMaker is not active, it is still resident (called Terminate
  60.         and Stay Resident). As you execute your application, you call
  61.         DemoMaker by pressing a Hot key combination. DemoMaker suspends
  62.         the application that is running, swaps itself back into memory,
  63.         and captures the screen image. It then allows you to enter text
  64.         in a configurable dialog window. You may type in your text and
  65.         position the dialog box at this time, or edit and reposition the
  66.         dialog box later. DemoMaker then swaps itself out of active
  67.         memory, and restores your application at the exact point where
  68.         it was interrupted. You can repeat this cycle indefinitely,
  69.         DemoMaker keeps track of all your screen captures. Once you have
  70.         completed the capture process, you terminate your application,
  71.         return to the DOS prompt, and summon DemoMaker again with the
  72.         Hot key combination. You can now edit the text and dialog
  73.         windows, delete or rearrange the screen captures that you have
  74.         made. If need be, you can restart your application and add more
  75.         screen captures at a later time. After you are satisfied with
  76.         the appearance of the display, DemoMaker will create a self
  77.         executing demo program that you can distribute freely!
  78.  
  79.  
  80.         Using DemoMaker
  81.         ~~~~~~~~~~~~~~~
  82.         You must run DemoMaker from the DOS command line ONLY. It is
  83.         important that you do NOT use any DOS Shell or Menu program to
  84.         load DemoMaker! DemoMaker requires all available memory, and
  85.         will use EMS/XMS if it is found. No command line arguments are
  86.         required. DemoMaker can ONLY work with text mode programs.
  87.  
  88.         A batch file called RUN.BAT is included in the archive, it first
  89.         SETs an environmental variable for DemoMaker and then executes
  90.         the program. It is recommended that this batch file be used to
  91.         start DemoMaker. Simply type RUN on the DOS command line and
  92.         DemoMaker will be executed.
  93.  
  94.         You will see a menu in the center of your display. There are
  95.         five options in the menu, but the first three options will be
  96.         shaded out and unavailable until later.
  97.  
  98.         The menu options are:
  99.  
  100.         View/Edit Demo screens
  101.         Kill screens & restart
  102.         Write presentation
  103.         Execute application
  104.         Unload and Quit to DOS
  105.  
  106.         View/Edit Demo screens - This option only comes active if you
  107.         have used DemoMaker before and have at least one screen saved. A
  108.         detailed description follows.
  109.  
  110.         Kill screens & restart - This option only comes active if you
  111.         have used DemoMaker before and have at least one screen saved.
  112.         It deletes all saved screen information, and starts afresh.
  113.  
  114.         Write presentation - This option only comes active if you have
  115.         used DemoMaker before and have at least one screen saved. It
  116.         creates an EXEcutable presentation program using the screens
  117.         that you have saved. The saved screens are retained, allowing
  118.         you to make changes if necessary and recreate the EXEcutable
  119.         presentation.
  120.  
  121.         Execute application - This option causes DemoMaker to Terminate
  122.         and Stay Resident in system memory. It will return you to the
  123.         DOS prompt to execute the application that you wish to make the
  124.         demo of. A detailed description follows.
  125.  
  126.         Unload and Quit to DOS - This option unloads DemoMaker from
  127.         memory completely, and returns control to DOS. Always exit the
  128.         program before shutting the power off on your computer system to
  129.         ensure that all datafiles are updated and closed properly.
  130.  
  131.  
  132.         Making our first demo
  133.         ~~~~~~~~~~~~~~~~~~~~~
  134.         Change to the directory in which DemoMaker has been installed.
  135.         Start DemoMaker from the DOS command line, by using the RUN
  136.         batch file included. When the menu appears, select the option to
  137.         Execute your application. Use the Up and the Down arrow keys to
  138.         navigate the menu, select with the Enter key.
  139.  
  140.         DemoMaker will swap itself out of active memory, remaining
  141.         resident and return you to the DOS prompt with a message:
  142.  
  143.         "Ready to create a demo of your application."
  144.         "Press the Left-Shift + Right-Shift keys to activate."
  145.  
  146.         You may now execute your application program. To capture a
  147.         screen and save it, simply press the Hot keys Left-Shift and
  148.         Right-Shift simultaneously. Your application will be suspended,
  149.         and DemoMaker will swap itself back and take control. You will
  150.         see a dialog box superimposed over the original screen, with a
  151.         list of available commands on the bottom of the display:
  152.  
  153.         "F10 save, Esc cancel, Ctl resize, Ctl move, Ctl +- colors"
  154.  
  155.         You can now type your information about the screen displayed in
  156.         the dialog box. The Control + arrow keys change the size of the
  157.         dialog box, any text that exists is reformatted to fit in the
  158.         provided space. You have a limit of 256 characters in the text,
  159.         any more will be ignored. If your text occupies more lines than
  160.         are visible, the hidden text will remain hidden, you must resize
  161.         the dialog box to best fit your text. The number that appears in
  162.         the upper left corner of the dialog box is the current screen
  163.         number, this controls the order in which the screens will appear
  164.         in your final presentation and can be changed with the View/Edit
  165.         option.
  166.  
  167.         The Control + PageUp, PageDown, Insert and Delete keys move the
  168.         entire dialog box around the screen. Control + PageUp moves the
  169.         box up, Control + PageDown moves the box down, Control + Insert
  170.         moves the box left and Control + Delete moves the box right. You
  171.         can only move the dialog box within the confines of the display
  172.         dimensions.
  173.  
  174.         If you leave the dialog box empty with no text, DemoMaker will
  175.         not add the dialog box in the screen when the final presentation
  176.         program is created. This is useful if you wish to display a full
  177.         screen image. The empty dialog box will remain visible when you
  178.         View/Edit the screen, to allow you to add text at a later time.
  179.  
  180.         You can change the colors of the dialog box and text by pressing
  181.         the Control + [PLUS] key for the text color, and the Control +
  182.         [MINUS] key for the background color. Once you have entered your
  183.         text and positioned the dialog box, save the screen information
  184.         by pressing the F10 key. To discard the screen press the Escape
  185.         key. You may edit the text and change the colors or position of
  186.         the dialog box at a later time by using the View/Edit option.
  187.  
  188.         After you save (or discard) the screen, DemoMaker will swap
  189.         itself out of memory again, and restore your application to the
  190.         exact state it was before the interruption. You may now continue
  191.         to use your application and create more screens using the same
  192.         process explained above.
  193.  
  194.         It may take DemoMaker a few seconds to swap itself in and out of
  195.         active memory. If any EMS memory is available, it will be used
  196.         for faster swapping. Do NOT load any other TSR programs after
  197.         DemoMaker is resident!
  198.  
  199.         Once you have a collection of screens saved, you can shut down
  200.         your application and return to the DOS prompt. Now press the
  201.         Left-Shift + Right-Shift Hot keys simultaneously. DemoMaker
  202.         knows when it is summoned over a DOS prompt, and will offer its
  203.         menu.
  204.  
  205.         Select the View/Edit option. You will see the first screen that
  206.         you have saved, along with the dialog box and your text. You can
  207.         now edit the text, or resize, or move, or change the colors of
  208.         the dialog box.
  209.  
  210.         The F10 key saves any changes and goes to the next saved screen.
  211.         If you were at the last screen this will return you to the menu.
  212.  
  213.         The Control + BackSpace key takes you to the previous screen. If
  214.         any changes were made, they will be lost, you must save all
  215.         changes by pressing the F10 key.
  216.  
  217.         Pressing the Escape key takes you to the next saved screen. If
  218.         any changes were made, they will be lost, you must save all
  219.         changes by pressing the F10 key. If you were at the last screen
  220.         this will return you to the menu.
  221.  
  222.         The Control + J key jumps to a specified screen number. You will
  223.         be prompted to enter the specific screen number to jump to.
  224.  
  225.         The Control + K key kills the current screen. When a screen is
  226.         deleted a flashing DEL message is seen in the lower left corner
  227.         of the dialog box. Pressing Control + K at a deleted screen will
  228.         revive the screen, making it active again. Deleted screens are
  229.         not used when the final presentation is prepared, but they will
  230.         remain visible when editing to allow resurrection.
  231.  
  232.         The Control-O key changes the order in which the screen will
  233.         appear in the final presentation. You will be prompted to enter
  234.         the new order number to assign the screen. If two screens are
  235.         assigned the same order number, the screen that was created
  236.         first will appear before the other.
  237.  
  238.         The Control + Q key will return you to the menu immediately.
  239.  
  240.         Once you are satisfied with the appearance and order of all the
  241.         active screens, select the Write presentation option. You will
  242.         be prompted to enter a file name for the executable program. The
  243.         default presentation file name is DEMO.EXE, simply press Enter
  244.         to accept the default name. An extension of .EXE is assumed if
  245.         one is not entered. DemoMaker will now create the presentation
  246.         EXEcutable program, displaying each screen as it progresses, in
  247.         the order that you have specified. Deleted screens are not
  248.         included in the final presentation, and any screens with empty
  249.         dialog boxes will not have the box included in the image. After
  250.         a few seconds of disk activity, DemoMaker will display the
  251.         message:
  252.  
  253.         "Presentation file created! Press any key ..."
  254.  
  255.         Pressing any key will return you to the menu. You may now Unload
  256.         DemoMaker and Quit to DOS to view the presentation program that
  257.         you have created. Once the final presentation program has been
  258.         completed, you can select the Kill screens & restart option,
  259.         allowing you to create a new demo for another application.
  260.  
  261.         DemoMaker can also accept an alternate data file name as a
  262.         command line parameter, which it will load/create instead of the
  263.         default DISPLAY.DMK file. For example, to retain an existing
  264.         screen set and create a new data file, call the RUN batch file
  265.         with the new file name as a command line parameter:
  266.  
  267.         RUN SOMEFILE
  268.  
  269.         A file extension of .DMK is assumed if one is not entered. If
  270.         the specified data file does not exist, a new date file will be
  271.         created. You can use several different data files by using this
  272.         method, but DemoMaker must be Unloaded and restarted with the
  273.         new data file name on the command line.
  274.  
  275.         DemoMaker creates some temporary files while it is running and
  276.         even while it is memory resident, do NOT delete any of these
  277.         files!
  278.  
  279.         If you attempt to run DemoMaker while it is already in memory
  280.         (and suspended), it will remind you that it is already active
  281.         and will not load itself again. If any errors occur, DemoMaker
  282.         will attempt to unload from memory and will terminate with an
  283.         error message.
  284.  
  285.  
  286.         Known incompatibilities
  287.         ~~~~~~~~~~~~~~~~~~~~~~~
  288.         The EXEcutable presentation programs created by DemoMaker may
  289.         not display on some ancient XT machines (pre-1986).
  290.  
  291.         Since the main impact of the presentations is in full color,
  292.         their appearance on monochrome systems is unpredictable.
  293.  
  294.         The DemoMaker program is a large TSR program, and requires all
  295.         available conventional, EMS, and XMS memory. It is recommended
  296.         that no exotic TSRs or device drivers be used to prevent memory
  297.         conflicts.
  298.  
  299.         Do NOT run DemoMaker under DesqView! The two programs do not get
  300.         along very well, this problem is being worked on and hopefully
  301.         will be resolved in a future release.
  302.  
  303.         The DemoMaker will NOT work with graphics screens! Only text
  304.         video modes are supported.
  305.  
  306.         Several graphic cards (notably VGA cards) will cause the cursor
  307.         to appear abnormal while DemoMaker is being used. The RUN.BAT
  308.         file that is provided uses an environmental variable called
  309.         DEMOSET with two possible options, BADCURS to prevent the cursor
  310.         madness; and E0 to restrict EMS memory usage by DemoMaker. It is
  311.         recommended that this RUN.BAT file is used to start DemoMaker,
  312.         since it will set the DEMOSET variable automatically each time.
  313.  
  314.         DemoMaker uses EMS memory, XMS memory, or if neither are found,
  315.         disk space to swap. EMS and XMS memory swapping is much faster
  316.         than disk swapping.
  317.  
  318.  
  319.         Where?
  320.         ~~~~~~
  321.         Updates to DemoMaker can be found at the following official
  322.         distribution sites arranged by area code. Modem speed and type
  323.         are specified, and !DL! indicates first call downloads allowed.
  324.  
  325. Support BBS - The Photographers Network BBS 718-876-0337 9600 v.32 !DL!
  326. ~~~~~~~~~~~
  327. Lightning 201-483-5141 2400             Blue Lake 503-656-9790 14.4 v42
  328. Exch Club 206-964-5949 14.4                       503-657-4719 9600 HST
  329. 3rdMillnm 208-664-2983 9600 !DL!        BabbleBBS 602-292-6576 16.8 DS
  330. CityPeopl 212-255-6656 14.4 v42 !DL!    Dons BBS  609-435-1663 14.4
  331.           212-255-3730 14.4 v42 !DL!    SEOhioCmp 614-432-2899
  332. PosterBrd 212-685-8309 9600             Nexxus    703-898-7205 9600 v32
  333. Nice Guys 212-737-6192 14.4 v32         Exchange  704-342-2333 14.4 HST
  334. PlanetBBS 214-306-8269 14.4 DS                    704-339-0333 14.4 v32
  335. RobinsEgg 214-964-8726 9600             Point BBS 715-345-1327 14.4
  336. Unnamed   215-540-0141 2400             Bklyn BBS 718-375-6569 14.4 v42
  337. OldTimers 301-645-1049 9600             Queens SE 718-628-6661 2400
  338. US Projct 302-529-1650 14.4 HST         Systmatic 718-716-6198 14.4 v42
  339. LookngGls 305-346-8524 16.8 HST DS      Madhouse  718-893-2318 2400 !DL!
  340. GreatEscp 310-676-3534 14.4             Computec  718-983-9152 9600 HST
  341.           310-676-4282 16.8             UtahDataL 801-943-4616 2400
  342. RefinrFir 313-664-0437 2400 !DL!                  801-942-2533 14.4 >7pm
  343. JetStream 316-788-9913 14.4             C Pro Run 804-587-4090 14.4
  344. PUMA BBS  318-443-1065 14.4 DS !DL!     TwlghtZn  805-256-4931 16.8 HST
  345.           318-442-0669 14.4 DS !DL!     Wet Spot  805-736-7066 14.4 v32
  346. CyberZone 401-732-0258 9600 DS          DarbyRsch 814-825-7905 14.4 HST
  347. Bun's BBS 415-756-5098 14.4 !DL!        Maranatha 903-465-4022 9600
  348.           415-991-2995 14.4 !DL!        Night Owl 904-472-5714 14.4
  349. Club Cave 416-796-1400 9600             GraphUnlm 909-862-5319 14.4 DS!DL!
  350. TrekKy!   502-762-6963 14.4 !DL!
  351.  
  352.         FIDO Freq addresses 1:150/420 (US Project, DE)
  353.                             1:300/204 (Dane's BBS, AZ)
  354.  
  355.         (Sole distribution site for Europe)
  356.         Enterprise BBS The Netherlands +31-5950-3933 14.4 !DL!
  357.  
  358.  
  359.         Thanks go to the ßeta team ...
  360.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  361.         Ron 'Q' Kulick,
  362.         Harris 'Speedy' Lam,
  363.         David 'The Man' Kaufman,
  364.         Rick 'Trekky' Alvey,
  365.         Tom 'Smurf' Murphy,
  366.         Joe 'Wave' Eversole,
  367.         Dane 'Babble' Beko,
  368.         Bundy 'Buns' Chanock,
  369.         and Marcus 'Modem' Byron for his invaluable help.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.